Version 8.0 / .NET 6 Readiness
Upgrading your OneStream Platform to version 8.0 or later requires .NET 6 for full compatibility.
This Platform release includes updates and enhancements to the Business Rules compiler to improve syntax detection. Administrators must resolve these errors to compile business rules fully. Warning messages identify line items that will function, but you should update them to support the latest compiler’s requirements. Resolving these warnings varies. You may be able to use a provided replacement function or change a function’s properties.
Business Rules
For more information, visit the Platform v8+ Upgrades page on ONECommunity.
Custom DLLs
If your implementation / business rules reference any custom DLLs that are not provided by OneStream, these DLLs must be .NET 6 compatible. Contact OneStream Support (support.onestreamsoftware.com) to discuss available upgrade options.
ERPConnect (SAP)
ERPConnect45.dll enabling connection to SAP systems is no longer available in Platform 8.0. A newer version ERPConnectStandard20.dll is available through the download "DLL Packages" from the Platform page of the Solution Exchange.
On-Prem Customers:
-
Download ERPConnectStandard20.dll file to your integrations folder.
-
Install the required Visual C++ 2013 Runtime.
-
Download and copy SAP NetWeaver RFC Library DLL (sapnwrfc.dll) to the integrations folder.
See Theobald Software ERPConnect Requirements for more information. -
Modify your business rules to use the ERPConnectStandard20.dll.
Cloud/SaaS Customers: ERPConnect is available through the Smart Integration Connector (SIC). See ERPConnect section of the SIC Guide for installation details or contact OneStream Support (support.onestreamsoftware.com) to discuss morel upgrade options.
Smart Integration Connector
Smart Integration Connector is required for OneStream Cloud integration with local customer data sources when using OneStream Platform version 8.0 or higher. VPN is no longer supported with version 8.0 or higher and will reach end of service for Platform versions prior to version 8 on August 31, 2024.
Authentication
Cloud Customers: OneStream IdentityServer is required for OneStream Platform 8.0.
Self-hosted Customers:
.NET 6 Desktop Runtime and ASP.NET Runtime
To best align with Microsoft's long-term support strategy, OneStream Platform version 8.x is built using .NET 6. Platform 8.x users are required to use the latest versions of .NET Desktop Runtime x64 and ASP .NET Core Runtime Hosting Bundle (6.0.14 minimum).
VBA Changes
ProcessSSOAuthenticationAndCreateToken is no longer supported as an authentication option from VBA scripts.
Client API Changes
Client API is no longer provided with Platform version 8.0 or higher. OneStream recommends Task Scheduler or the REST API to replace existing Client API use cases.
Tiles Page
The ClickOnce journey is enhanced to launch the application with a single click of the Open button while eliminating the tiles page.
Help Documentation
Help documentation has moved from within the application to https://documentation.onestream.com. Clicking the in-app help icon routes you to this site.
Business Rule Groups
In version 8.0 the default for new Business Rule Access or Maintenance Groups is the Administrators group. This default can be changed by the Server Configuration Utility.
MarketPlace Solution Compatibility
The following MarketPlace Solutions are compatible with OneStream Platform version 8.0.
| MarketPlace Solution | Version |
|---|---|
| Administrator Solution Tools | PV620 SV101 |
| Application Control Manager | PV710 SV100 |
| Capital Planning | PV620 SV102 |
| Cash Planning | PV620 SV102 |
| Cloud Administration Tools | PV600 SV100 |
| Contract Compliance | PV620 SV102 |
| Dimension Comparison | PV600 SV100 |
| Excel Add-in Installer | PV710 SV100 |
| File Explorer Manager | PV650 SV102 |
| Financial Close | PV710 SV201 |
| Guided Reporting | PV600 SV102 |
| Help Desk | PV640 SV100 |
| Marketplace Solution Tools | PV720 SV100 |
| Metadata Builder | PV520 SV101 |
| Model Maker | PV680 SV201 |
| Parcel Service | PV630 SV100 |
| People Planning | PV620 SV103 |
| Predictive Analytics 123 | PV620 SV101 |
| Provision Request Manager | PV440 SV104 |
| Reporting Compliance | PV620 SV103 |
| Sales Planning | PV620 SV102 |
| Sample Templates | PV600 SV100 |
| Scenario Analysis 123 | PV530 SV100 |
| Security Audit Reports | PV620 SV100 |
| Standard Application Reports | PV610 SV201 |
| Standard Cube View Styles | PV410 SV100 |
| Standard System Reports | PV430 SV102 |
| System Diagnostics | PV620 SV202 |
| Table Data Manager | PV620 SV100 |
| Task Manager | PV660 SV102 |
| Tax Provision | PV620 SV200 |
| Thing Compliance | PV620 SV102 |
| Thing Planning | PV620 SV101 |
| XML Security Remover | PV410 SV100 |